feat(paywalls): add web_view message model and parsing (PWENG-98) by alexrepty · Pull Request #3654 · RevenueCat/purchases-android

alexrepty · 2026-06-25T15:33:45Z

Checklist

If applicable, unit tests
If applicable, create follow-up issues for purchases-ios and hybrids

Motivation

Defines the inbound message model and parsing for web_view ↔ native communication, so messages from web content are validated before reaching app code.

Part of PWENG-98.

Description

Adds the public PaywallWebViewMessage plus the PaywallWebViewMessageHandler / PaywallWebViewController surface.
Adds the internal WebViewMessageType and WebViewMessageParser: validates the flat envelope, enforces payload size / nesting-depth caps, requires the component_id to match the rendered component, and validates per-type fields (rc:step-loaded, rc:step-complete, rc:request-variables, rc:error); unknown types are dropped.
Pure data/logic — no live WebView bridge yet.
Tested by WebViewMessageParserTest.

iOS parity: mirrors purchases-ios (web-view-bridge-wiring).
Stack (merge bottom-up): schema → rendering → CSP → value types → message model → variables provider → JS bridge → wiring.

Note

Low Risk
Additive public API and internal validation logic with no runtime WebView integration or purchase flow changes in this PR.

Overview
Introduces the public surface for Paywalls V2 web_view ↔ native messaging: PaywallWebViewMessage, PaywallWebViewMessageHandler, and PaywallWebViewController (reply via postVariables / postMessage using PaywallWebViewValue). App code will wire the handler through PaywallOptions.Builder.setWebViewMessageHandler in a follow-up; the SDK does not auto-dismiss or purchase on rc:step-complete.

Adds internal parsing via WebViewMessageParser: validates the flat postMessage envelope, caps payload size (64KB) and nesting depth, requires component_id to match the rendered web view, handles rc:step-loaded, rc:step-complete, rc:request-variables, and rc:error, and drops unknown types and invalid payloads. api.txt is updated for the new types.

No live WebView bridge in this PR—data and validation only, covered by WebViewMessageParserTest.

^{Reviewed by Cursor Bugbot for commit a1cc787. Bugbot is set up for automated code reviews on this repo. Configure here.}

alexrepty · 2026-06-25T15:34:04Z

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit cdc1156. Configure here.}

Adds a bidirectional JS<->native bridge for the Paywalls V2 `web_view` component: a document-start `window.RevenueCatWebView` shim, message parsing/validation (`WebViewMessageParser`, `WebViewMessageType`), the public `PaywallWebViewMessage` / `PaywallWebViewValue` / `PaywallWebViewMessageHandler` / `PaywallWebViewController` surface, and an SDK-managed variables provider (locale, color scheme, custom variables). Apps opt in via `PaywallOptions.setWebViewMessageHandler(...)`, threaded through `PaywallState` / `OfferingToStateMapper`. Regenerates ui/revenuecatui/api.txt for the new public API. Recommended labels: pr:feat, pr:RevenueCatUI, feat:Paywalls_V2

emerge-tools · 2026-07-10T18:51:41Z

📸 Snapshot Test

1 modified, 620 unchanged

Name	Added	Removed	Modified	Renamed	Unchanged	Errored	Approval
TestPurchasesUIAndroidCompatibility com.revenuecat.testpurchasesuiandroidcompatibility	0	0	1	0	338	0	⏳ Needs approval
TestPurchasesUIAndroidCompatibility Paparazzi com.revenuecat.testpurchasesuiandroidcompatibility.paparazzi	0	0	0	0	282	0	N/A

🛸 Powered by Emerge Tools

This was referenced Jun 25, 2026

feat(paywalls): add web_view component schema (PWENG-98) #3650

Closed

feat(paywalls): render web_view component (PWENG-98) #3651

Closed

feat(paywalls): isolate web_view content with a fixed CSP (PWENG-98) #3652

Closed

alexrepty mentioned this pull request Jun 25, 2026

feat(paywalls): wire web_view messaging into the paywall (PWENG-98) #3653

Closed

2 tasks

alexrepty added pr:feat A new feature pr:RevenueCatUI feat:Paywalls_V2 labels Jun 25, 2026

alexrepty changed the title ~~feat(paywalls): add web_view bidirectional messaging~~ feat(paywalls): add web_view message types and parsing Jun 25, 2026

This was referenced Jun 25, 2026

feat(paywalls): add web_view JavaScript bridge (PWENG-98) #3655

Closed

feat(paywalls) Generic Web View #3501

Closed

alexrepty changed the base branch from alexrepty/paywalls-web-view-csp to graphite-base/3654 June 26, 2026 10:49

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch from 21899a1 to 8558b7d Compare June 26, 2026 10:49

alexrepty force-pushed the graphite-base/3654 branch from 66c0ccb to 3e62e49 Compare June 26, 2026 10:49

alexrepty changed the base branch from graphite-base/3654 to alexrepty/paywalls-web-view-value-types June 26, 2026 10:49

This was referenced Jun 26, 2026

feat(paywalls): add web_view message value types (PWENG-98) #3662

Closed

feat(paywalls): add web_view SDK variables provider (PWENG-98) #3663

Closed

alexrepty changed the title ~~feat(paywalls): add web_view message types and parsing~~ feat(paywalls): add web_view message model and parsing Jun 26, 2026

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch from 8558b7d to 2790f47 Compare June 26, 2026 14:20

alexrepty force-pushed the alexrepty/paywalls-web-view-value-types branch 2 times, most recently from 2716386 to 27793a8 Compare June 26, 2026 14:26

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch 4 times, most recently from b70692b to c8ba63e Compare June 29, 2026 09:58

alexrepty changed the title ~~feat(paywalls): add web_view message model and parsing~~ feat(paywalls): add web_view message model and parsing (PWENG-98) Jun 29, 2026

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch from c8ba63e to 5525f6c Compare June 29, 2026 13:58

alexrepty force-pushed the alexrepty/paywalls-web-view-value-types branch from 27793a8 to 81453b8 Compare June 29, 2026 13:58

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch from 5525f6c to d7f8fa1 Compare June 29, 2026 14:14

alexrepty force-pushed the alexrepty/paywalls-web-view-value-types branch from 81453b8 to 5505947 Compare June 29, 2026 14:14

alexrepty marked this pull request as ready for review June 29, 2026 14:42

alexrepty requested a review from a team as a code owner June 29, 2026 14:42

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch from d7f8fa1 to 86b7b79 Compare June 30, 2026 07:44

alexrepty force-pushed the alexrepty/paywalls-web-view-value-types branch from 5505947 to 74610d7 Compare June 30, 2026 07:44

cursor Bot reviewed Jun 30, 2026

View reviewed changes

Comment thread ...n/kotlin/com/revenuecat/purchases/ui/revenuecatui/components/webview/WebViewMessageParser.kt

alexrepty force-pushed the alexrepty/paywalls-web-view-value-types branch from 74610d7 to a42c874 Compare June 30, 2026 08:43

alexrepty force-pushed the alexrepty/paywalls-web-view-message-model branch from 86b7b79 to cdc1156 Compare June 30, 2026 08:43

cursor Bot reviewed Jun 30, 2026

View reviewed changes

Comment thread ...n/kotlin/com/revenuecat/purchases/ui/revenuecatui/components/webview/WebViewMessageParser.kt

AlvaroBrey force-pushed the alexrepty/paywalls-web-view-message-model branch from cdc1156 to 7c75281 Compare July 6, 2026 08:12

AlvaroBrey force-pushed the alexrepty/paywalls-web-view-value-types branch from a42c874 to 7aceb78 Compare July 6, 2026 08:12

AlvaroBrey self-assigned this Jul 6, 2026

AlvaroBrey force-pushed the alexrepty/paywalls-web-view-value-types branch from 7aceb78 to cf8d3d0 Compare July 6, 2026 13:57

AlvaroBrey force-pushed the alexrepty/paywalls-web-view-message-model branch from 7c75281 to a1cc787 Compare July 6, 2026 13:57

AlvaroBrey marked this pull request as draft July 6, 2026 14:42

AlvaroBrey force-pushed the alexrepty/paywalls-web-view-message-model branch from a1cc787 to f8d54ec Compare July 7, 2026 13:22

AlvaroBrey force-pushed the alexrepty/paywalls-web-view-value-types branch from cf8d3d0 to 9cad6e3 Compare July 7, 2026 13:22

AlvaroBrey mentioned this pull request Jul 7, 2026

Add paywall-tester web_view sample #3724

Closed

AlvaroBrey removed their assignment Jul 9, 2026

JZDesign force-pushed the alexrepty/paywalls-web-view-message-model branch from f8d54ec to 77a5162 Compare July 10, 2026 16:40

JZDesign force-pushed the alexrepty/paywalls-web-view-value-types branch from 9cad6e3 to 0923d25 Compare July 10, 2026 16:40

JZDesign force-pushed the alexrepty/paywalls-web-view-message-model branch from 77a5162 to 9e59a49 Compare July 10, 2026 18:31

JZDesign force-pushed the alexrepty/paywalls-web-view-value-types branch from 0923d25 to 2a218da Compare July 10, 2026 18:31

JZDesign mentioned this pull request Jul 13, 2026

feat(paywalls): web_view component (PWENG-98) #3757

Draft

AlvaroBrey closed this Jul 14, 2026

AlvaroBrey deleted the alexrepty/paywalls-web-view-message-model branch July 14, 2026 16:20

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(paywalls): add web_view message model and parsing (PWENG-98)#3654

feat(paywalls): add web_view message model and parsing (PWENG-98)#3654
alexrepty wants to merge 1 commit into
alexrepty/paywalls-web-view-value-typesfrom
alexrepty/paywalls-web-view-message-model

alexrepty commented Jun 25, 2026 •

edited by cursor Bot

Loading

Uh oh!

alexrepty commented Jun 25, 2026 •

edited by AlvaroBrey

Loading

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

emerge-tools Bot commented Jul 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

alexrepty commented Jun 25, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Checklist

Motivation

Description

Uh oh!

alexrepty commented Jun 25, 2026 • edited by AlvaroBrey Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

emerge-tools Bot commented Jul 10, 2026

📸 Snapshot Test

1 modified, 620 unchanged

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

alexrepty commented Jun 25, 2026 •

edited by cursor Bot

Loading

alexrepty commented Jun 25, 2026 •

edited by AlvaroBrey

Loading